00-目录与概述
# Xiuno BBS 插件开发标准化操作流程 (SOP)
## 文档概述
本SOP基于对Xiuno BBS 4.0核心框架源码、官方开发文档、以及20+个社区插件的深度逆向分析,系统总结出一套可操作的插件开发标准流程。
## 版本说明
- **适用系统**: Xiuno BBS 4.0+
- **PHP版本**: 7.2+ (推荐 8.0+)
- **数据库**: MySQL 5.7+ / MariaDB 10.2+
- **前端技术栈**: Bootstrap 5 + HTMX + 原生JS
## 文件结构
| 章节 | 文件 | 内容 |
|------|------|------|
| 第1章 | [01-环境搭建与项目初始化](01-环境搭建与项目初始化.md) | 开发环境配置、项目结构、调试模式 |
| 第2章 | [02-核心机制深度解析](02-核心机制深度解析.md) | Hook机制、Overwrite机制、编译时合并原理 |
| 第3章 | [03-插件目录结构与规范](03-插件目录结构与规范.md) | 标准目录、命名规范、conf.json详解 |
| 第4章 | [04-插件生命周期管理](04-插件生命周期管理.md) | 安装、卸载、升级、启禁用流程 |
| 第5章 | [05-数据存储与Model层开发](05-数据存储与Model层开发.md) | KV/Cache/Setting/数据库表、Model函数规范 |
| 第6章 | [06-路由与控制器开发](06-路由与控制器开发.md) | 路由注册、参数获取、请求处理 |
| 第7章 | [07-视图与前端开发](07-视图与前端开发.md) | 模板语法、HTM hook、JS交互、HTMX |
| 第8章 | [08-设置页面与管理后台](08-设置页面与管理后台.md) | 前台设置页、后台管理路由、表单处理 |
| 第9章 | [09-技术难点与避坑指南](09-技术难点与避坑指南.md) | 常见陷阱、兼容性问题、性能优化 |
| 第10章 | [10-完整插件开发实战](10-完整插件开发实战.md) | 从零到一的完整开发案例 |
## 版本二
AI技能文件见: [xiuno-bbs-plugin-generator.md](xiuno-bbs-plugin-generator.md)
## 参考资源
- Xiuno BBS 源码: `m:\laragon\www\xxiunobbs\`
- 插件示例: `m:\laragon\www\xxiunobbs\plugin\`
- 开发文档: `m:\laragon\www\xxiunobbs\plugin\abs_theme_aether\开发资料\`
- 核心框架: `model/plugin.func.php`